Actividades

Más reciente

False

Actividades UIAutomation

Última actualización 3 de abr. de 2024

Configuración avanzada del Descriptor

Para obtener más información sobre el uso de las funciones más avanzadas de la pantalla de selección, vea el siguiente vídeo.

Duplicados

Indicar un destino puede producir duplicados, que son otros elementos de IU que se perciben como extremadamente similares al elemento de IU de destino y pueden hacer que la automatización falle en Runtime. Cuando se encuentran duplicados, se resaltan en amarillo y tienen una etiqueta encima de ellos que contiene una letra que corresponde al método de destino que encontró cada duplicado:

Una de las mejores formas de evitar duplicados es indicando un anclaje.

Anclajes

Para crear un descriptor fiable, se recomienda indicar un anclaje después de indicar el destino. Puedes indicar hasta tres anclajes para un destino. Los anclajes se pueden encontrar en varios escenarios, como se describe a continuación:

Anclaje encontrado automáticamente

Después de indicar un destino, se intenta identificar automáticamente un anclaje para este.

Importante: Si no se encuentra un anclaje con 100% de certeza, o si se encuentran duplicados, no se considera como un anclaje automático.

Si se encuentra un anclaje automático con éxito, se resalta en azul y la herramienta de ayuda de selección confirma que el destino y su anclaje son correctos.

Método de identificación de anclaje

En esta sección puedes encontrar más detalles técnicos sobre el método en el que se realiza esta búsqueda.

Una vez que se indica un destino, se identifica el tipo del elemento de IU indicado. Se buscan los siguientes elementos e direcciones:

Botón: dentro del elemento.
Casilla de verificación: a la derecha del elemento.
Desplegable: a la izquierda y encima del elemento.
Cuadro de entrada: a la izquierda y encima del elemento. En el caso de la automatización del navegador, la etiqueta también se busca dentro del cuadro de entrada, buscando el atributo AreaLabeledBy . Si esta etiqueta no está identificada, se busca un elemento con tag=label y for='id of the input box' .
Botón de opción: a la derecha del elemento.
Imagen: a la derecha y debajo del elemento.

Dependiendo del tipo de elemento que se identifique, se busca un anclaje correspondiente para el elemento automáticamente.

Un anclaje identificado automáticamente tiene la forma de un elemento de texto que siempre está presente cerca del elemento de destino y, por lo tanto, se puede utilizar para identificar el elemento en Runtime con más precisión.

Si ninguna de las direcciones anteriores proporciona resultados, se utiliza un caso genérico que busca en la jerarquía de elementos un anclaje adecuado.

Añadir un anclaje manualmente

En caso de que un anclaje no se encuentre automáticamente y no se agregue al destino especificado, el asistente de opciones de selección le notificará, como se muestra en la siguiente captura de pantalla:

En esta situación, puedes seleccionar manualmente un anclaje para tu elemento de destino. Al mantener el puntero sobre otro elemento, se resalta en azul y se conecta con una línea al destino que ha seleccionado. Para seleccionar el anclaje que desea, simplemente haga clic en el texto que desea utilizar como anclaje.

Mantener el puntero en el menú

También puede editar un elemento específico (ya sea de destino o de anclaje) accediendo al menú que se muestra al pasar el ratón sobre el elemento de destino. Este menú tiene múltiples opciones:

El cierra el proceso de indicación y guarda los cambios realizados.

El te permite orientar elementos independientemente de su contenido de texto específico. Esto puede ser útil cuando se intenta seleccionar el primer elemento en una lista de búsqueda cuando no se sabe exactamente con qué se va a rellenar la lista, o cuando se interactúa con un elemento dinámico que cambia su etiqueta debido a varias razones. El uso de esta característica al indicar un destino utiliza solo el método Selector difuso para la identificación, y elimina el selector difuso para asegurarse de que el elemento sigue siendo el objetivo independientemente de los cambios de etiqueta.

Al hacer clic en el , puedes seleccionar un elemento de la IU adyacente que actúe como anclaje adicional. Puedes indicar hasta tres anclajes para cualquier destino.

El El botón expande la sección de destino en las Opciones de selección, lo que te permite configurar los métodos de destino utilizados para el descriptor actual.

El elimina el destino que has indicado y te permite elegir otro.

Configurar el descriptor

Opciones

La sección Opciones se puede expandir para mostrar las siguientes opciones:

Aplicar cambios automáticamente : cuando se selecciona, aplica cambios automáticamente a los elementos de destino y de anclaje.
Sitios web dinámicos : cuando se selecciona, permite que el anclaje se mueva automáticamente de la izquierda a la parte superior del destino, o de arriba a la izquierda del destino, lo que le permite automatizar los sitios web dinámicos.
Visibilidad del elemento : comprueba si el elemento de la IU está visible o no. Hay tres opciones disponibles en el menú desplegable:
- Ninguno : no comprueba la visibilidad.
- Interactivo (para selector difuso) : opción predeterminada. Comprueba si el elemento es potencialmente visible, ignorando el desplazamiento de página y las obstrucciones de otras aplicaciones, o el hecho de que la aplicación está minimizada. Esta comprobación es útil cuando intenta asegurarse de que no está apuntando a elementos invisibles que existen en el DOM pero que están ocultos.
- Totalmente visible : garantiza que el elemento de la interfaz de usuario está visible en la pantalla.

Selector de ventanas

La sección Selector de ventana se puede ampliar para ver y editar el selector de la aplicación de destino indicada. También puedes utilizar el botón Abrir en UI Explorer para editar el selector de ventanas en UI Explorer.

Destino

El proceso interno de búsqueda de elementos de IU utiliza varios métodos de destino:

Estos métodos de destino son redundantes entre sí y hay una clasificación en función de la cual se utilizan los métodos de destino. La jerarquía tiene en cuenta el poder de orientación y la resistencia a los cambios de la IU de cada método de orientación. Por lo tanto, el orden en el que se encuentra el elemento de IU es el siguiente:

El método de orientación principal está representado por selectores: Selector estricto o Selector difuso.
El método de orientación secundario es Computer Vision.
El método de orientación terciaria es Imagen (deshabilitado de forma predeterminada).

El El icono se muestra junto al método de destino principal en tiempo de diseño, simulando el escenario en tiempo de ejecución.

Configuración predeterminada del proyecto para métodos de destino en todas las tecnologías

La siguiente tabla muestra la configuración predeterminada del proyecto para los métodos de destino en diferentes tecnologías.

Métodos de destino	Aplicaciones de escritorio	Navegadores web	Java	SAP
Selector estricto
Selector difuso
Computer Vision
Imagen

Configuración del proyecto: esperar al método de orientación principal hasta el tiempo de espera

La configuración del proyecto Esperar el método de destino principal hasta el tiempo de espera (Configuración del proyecto > Automatización de IU moderna), que está habilitada de forma predeterminada en los nuevos proyectos que comienzan con la versión 23.10.3 del paquete de actividades y que puede habilitarse manualmente para los proyectos creados antes de esta versión del paquete de actividades , ofrece al método de orientación principal algo de tiempo adicional para consumir su tiempo de espera completo hasta que se pueda utilizar cualquier método de orientación alternativo.

Si uno de los métodos de orientación principales logra encontrar el elemento de IU hasta que expira el tiempo de espera, entonces se utilizará como método para interactuar con el elemento de IU. El selector estricto es el método de orientación que primero busca el elemento de IU, seguido de cerca por el selector difuso. Además, el selector estricto tiene prioridad sobre el selector difuso.

Cuando el elemento de IU no es encontrado por los métodos de orientación principales hasta que se agota el tiempo de espera, por lo que tras todos los reintentos dentro del tiempo de espera asignado, ni el selector estricto ni el selector difuso encuentran el elemento de IU, solo entonces los métodos de orientación secundarios y terciarios comenzarán a buscar el elemento de IU en un tiempo de espera propio.

Esta configuración del proyecto también aporta más previsibilidad y visibilidad en los problemas relacionados con el selector para que puedas tener un mejor control sobre la orientación de los elementos de la IU, al tiempo que tienes la sólida alternativa que proporciona Computer Vision.

Si deshabilitas esta configuración del proyecto, todos los métodos de orientación competirán en en un solo tiempo de espera para encontrar el elemento de la IU en función de la jerarquía: un destino encontrado por el método de orientación de rango inferior solo se utiliza si un método de orientación de rango superior no lo hace.

Configuración del proyecto: mostrar las coincidencias más cercanas en el mensaje de error "Elemento no encontrado"

La configuración del proyecto Mostrar coincidencias más cercanas en el mensaje de error "Elemento no encontrado" (Configuración del proyecto > Automatización de IU moderna) está habilitada de forma predeterminada en los nuevos proyectos que comienzan con la versión 23.10.3 del paquete de actividades y se puede habilitar manualmente para los proyectos creados antes de esta versión del paquete de actividades. Cuando esta configuración está habilitada, si un selector falla, se muestra una advertencia en los registros que muestra el método utilizado para encontrar el elemento de la IU junto con diez sugerencias de las coincidencias de selector más cercanas que pueden utilizarse para reemplazar el selector defectuoso.

No se recomienda editar manualmente el descriptor, ya que todo este proceso está pensado para resultar fluido para el usuario y debe proporcionar buenos resultados sin la necesidad de una configuración avanzada. Aún así, si quieres configurar características más avanzadas para tu descriptor, puedes habilitar, deshabilitar y editar los métodos de destino.

Selector estricto

Los selectores son fragmentos XML que contienen los atributos de los elementos de la IU y sus elementos principales. Los selectores se utilizan para orientar los elementos de la IU en la pantalla, inspeccionándolos y sus atributos, y haciéndolos coincidir con los atributos del selector. Puedes obtener más información sobre qué es un selector en el ecosistema UiPath consultando esta página.

El selector Estricto del elemento de destino se puede editar desde su sección dedicada en la ventana Opciones de selección. También puedes utilizar el botón Abrir en UI Explorer para editar el selector en UI Explorer.

El campo Selector estricto admite el uso y la creación de variables y argumentos desde el menú de contexto (accesible haciendo clic con el botón derecho).

También puede seleccionar una parte del selector y usar el menú contextual para convertirlo directamente en una variable que se rellena previamente con su selección.

También puedes seleccionar una variable ya creada del menú desplegable Nombre de variable y usarla en tu selector.

La casilla de verificación Anular valor predeterminado te permite reemplazar el valor de tu variable predefinida con tu selección actual.

El botón Confirmar guarda los cambios que ha realizado en su selector.

Están disponibles los siguientes atajos de teclado:

Ctrl+Space: elegir variable
Ctrl+Shift+Space: elegir argumento
Ctrl+K: crear variable
Ctrl+M: crear argumento

Importante:

Si una variable y un argumento tienen el mismo nombre, la variable será siempre la predeterminada y se utilizará en el runtime.

Los argumentos con nombres idénticos a las variables se ocultan del menú de selección de variables en la pantalla de selección.

Los cambios realizados con variables y argumentos se pueden propagar a todas las demás instancias donde se encuentren. Por ejemplo, si se utiliza una variable tanto en los campos Selector estricto como en Selector difuso, cambiarla en uno de los campos generará un mensaje que le informará de que se encontró el mismo valor en otro campo y le ofrecerá la opción de reemplazar todas las instancias por el nuevo valor.

Los selectores estrictos también admiten comodines, que pueden utilizarse para reemplazar cero o varios caracteres en una cadena. Puedes encontrar más información sobre esta funcionalidad aquí.

Selector difuso

El selector difuso es muy similar al selector estricto, con la diferencia de que sus atributos son coincidentes difusos en lugar de coincidir perfectamente. Esto significa que un selector difuso puede generar múltiples elementos, a diferencia del selector estricto, que genera un solo elemento a la vez.

El selector difuso puede editarse desde la sección correspondiente en la ventana Opciones de selección.

La precisión de coincidencia del selector difuso se basa en el algoritmo de distancia de Levenshtein para hacer recuento de la similitud de los selectores. El valor predeterminado es 0.5 y se puede configurar desde el control deslizante Precisión o directamente desde el campo de entrada escribiendo un valor válido. La precisión de coincidencia se puede establecer dentro de un rango de 0,4 a 1, donde un valor inferior indica un mayor grado de difuminación, lo que significa que el selector difuso genera más elementos y un valor superior indica un menor grado de difuminación, lo que significa que el selector difuso genera menos elementos.

Al igual que el selector Estricto, el campo Selector difuso admite el uso y la creación de variables y argumentos, y también admite comodines. Para obtener más información, consulta la información proporcionada anteriormente.

Si el elemento indicado contiene texto, el texto se muestra en el cuadro de entrada debajo de la ventana de edición del Selector difuso. Si se muestra texto en este cuadro de entrada, en tiempo de Runtime debe encontrarse en el propio elemento para que se considere una coincidencia.

El menú desplegable junto al cuadro de entrada tiene las siguientes opciones:

El texto es/ El TextoInteriores/El TextoCompleto es (dependiendo del método de extracción de texto utilizado): muestra el texto que se extrae; el mejor método de extracción se identifica automáticamente y se recomienda su uso.
Ignorar texto : ignora el texto especificado en el cuadro de entrada.

Computer Vision

Computer Vision es un motor impulsado por IA que permite a los UiPath Robots ver y comprender cada elemento de IU en una pantalla de ordenador.Computer Vision mejora la orientación: cuando el controlador no puede "ver" algunos elementos de la IU, Computer Vision puede habilitar la automatización de la IU. Así que aumenta la fiabilidad y la resistencia al cambio en las automatizaciones basadas en la IU y es una potente alternativa a los otros métodos de destino.

Imagen

Si se utiliza la automatización de imagen para tu destino, también puedes ver la captura de pantalla del elemento, así como ajustar la precisión de la imagen. El valor predeterminado es 0,8 y se puede configurar desde el control deslizante Precisión o directamente desde el campo de entrada escribiendo un valor válido. La precisión se puede establecer dentro de un rango de 0,4 a 1. Para obtener más información, consulta la sección Automatización de imágenes y texto .

Si desea definir destinos de solo imagen, puede usar la selección de región de imagen (F3) o dibujar una selección de cuadro del área que desea usar como destino / anclaje mientras lo indica.

También puede utilizar la actualización para actualizar manualmente la imagen que has seleccionado, en caso de que la imagen del elemento haya cambiado desde que se indicó.

El método de orientación de imagen está deshabilitado de forma predeterminada en la configuración del proyecto.

Para habilitarlo en el nivel de proyecto, ve a Configuración del proyecto > Automatización de IU moderna > Métodos de destino - Aplicaciones de escritorio / Métodos de destino - Navegadores web / Métodos de destino - Java / Métodos de destino - SAP (dependiendo del tipo de aplicación que quieras automatizar) > Imagen > seleccionar Verdadero.

Para habilitar el método en un elemento especificado, el elemento debe ser válido.

Texto nativo

Si seleccionaste la casilla de verificación Habilitar texto nativo al indicar el elemento, se utiliza el método de destino Texto nativo. Este método te permite utilizar todas las etiquetas de texto que se identifican con el método Nativo para identificar el elemento con el que quieres interactuar.

La etiqueta de texto identificada a través de este método puede editarse desde su sección dedicada, y puedes especificar si quieres que el texto distinga o no entre mayúsculas y minúsculas usando el botón Alternar distinción entre mayúsculas y minúsculas .

Editar sin conexión

Cuando una aplicación ya no está abierta pero quieres editar su descriptor, selecciona Editar objetivo (E) en el menú contextual en el cuerpo de la actividad te pide Reintentar , Editar sin conexión o Cancelar .

Al seleccionar la opción Editar sin conexión , se abre la pantalla de selección en el modo de edición sin conexión. En el modo de edición sin conexión, no se pueden añadir anclajes, validar el descriptor u otra funcionalidad que requiera una aplicación en vivo.

Validando el descriptor

El proceso de validación garantiza que todas las combinaciones de métodos de búsqueda del destino funcionen correctamente. Puedes validar tu selección usando el botón Validar en la pantalla de selección.

Si tienes un par de destino y anclaje, cada uno de ellos utiliza todos los métodos de destino disponibles. Para encontrar el destino final, todas las combinaciones posibles de cada uno de estos elementos se emparejan con los elementos de la pantalla y se puntúa después de la coincidencia.

Después de realizar la validación, si se encuentran duplicados, se resaltan en la aplicación de destino. Si no se encuentran duplicados, aparecen iconos junto a los métodos de destino, informándole del estado de cada método de destino en una situación determinada. Se utilizan los siguientes símbolos:

: el método de destino más rápido

- el método funcionó, pero no fue el más rápido